Updates a keychain item.

OSStatus KCUpdateItem (
    KCItemRef item
);

item

A reference to the keychain item you wish to update. If you pass an item that has not been previously added to the keychain, KCUpdateItem does nothing and returns noErr.

function result

A result code. The result code errKCNoDefaultKeychain indicates that no default keychain could be found. The result code errKCInvalidItemRef indicates that the specified keychain item reference was invalid.

DISCUSSION

You can use the KCUpdateItem function to update a keychain item after changing its attributes or data. The item is written to the keychain's permanent data store. KCUpdateItem may display the Unlock Keychain dialog box if the keychain containing the item is currently locked.

VERSION NOTES

Available beginning with Keychain Manager 1.0.

AVAILABILITY

Under evaluation for Carbon. Available in CarbonLib 1.0 and later when KeychainLib 1.0 or later is installed. Exported by CarbonLib 1.0 and later and by KeychainLib 1.0 and later.

© 2000 Apple Computer, Inc. — (Last Updated 4/14/2000)